package com.liusy.serachengine.demo;


public interface ImageSearch extends Search {

	/**
	 * 此方法用于指定或清除由此搜索器返回的有关结果集的限制。为了建立限制，type 和 opt_value 均必须提供且有效。为了清除限制，请为
	 * type 提供一个有效值，或为 null 值指定 opt_value，或者不提供 opt_value 参数。
	 * 
	 * 此 API 当前支持以下限制类型：
	 * 
	 * a.search.Search.RESTRICT_SAFESEARCH - 当此限制类型指定为 type
	 * 值时，图片搜索结果会限于基于安全搜索值的图片。此类型的有效可选值如下所示：
	 * a.search.Search.SAFESEARCH_STRICT - 对露骨的文本和图片均应用严格的过滤
	 * a.search.Search.SAFESEARCH_MODERATE - 对露骨的图片应用过滤（默认操作）
	 * a.search.Search.SAFESEARCH_OFF - 不应用安全搜索过滤
	 * 
	 * 以下代码段演示了如何关闭安全搜索过滤。
	 * var searcher = new a.search.ImageSearch();
	 * searcher.setRestriction(a.search.Search.RESTRICT_SAFESEARCH,
	 * a.search.Search.SAFESEARCH_OFF);
	 * 
	 * a.search.ImageSearch.RESTRICT_IMAGESIZE - 当此限制类型指定为 type
	 * 值时，图片搜索结果会限于具有特定像素尺寸的图片。此类型的有效可选值如下所示：
	 * a.search.ImageSearch.IMAGESIZE_SMALL - 较小的正方形尺寸，图标
	 * a.search.ImageSearch.IMAGESIZE_MEDIUM - 从 2.5k 到 16k
	 * 像素的图片 a.search.ImageSearch.IMAGESIZE_LARGE - 从 16k 到
	 * 480k 像素的图片 a.search.ImageSearch.IMAGESIZE_EXTRA_LARGE -
	 * 大于或等于 480k 像素的图片 。
	 * 
	 * 以下代码段演示了如何仅检索限定图标大小的图片。
	 * var searcher = new
	 * a.search.ImageSearch();
	 * searcher.setRestriction(a.search.ImageSearch.RESTRICT_IMAGESIZE,
	 * a.search.ImageSearch.IMAGESIZE_SMALL);
	 * 
	 * a.search.ImageSearch.RESTRICT_COLORIZATION - 当此限制类型指定为
	 * type 值时，图片搜索结果会限于具有特定色彩的图片。此类型的有效可选值如下所示：
	 * a.search.ImageSearch.COLORIZATION_BLACK_AND_WHITE -
	 * 限于黑白（单色）图片 a.search.ImageSearch.COLORIZATION_GRAYSCALE -
	 * 限于灰度图片 a.search.ImageSearch.COLORIZATION_COLOR - 限于彩色图片
	 * 
	 * 以下代码段演示了如何仅检索灰度图片。 
	 * var searcher = new a.search.ImageSearch();
	 * searcher.setRestriction(a.search.ImageSearch.RESTRICT_COLORIZATION,
	 * a.search.ImageSearch.COLORIZATION_GRAYSCALE);
	 * 
	 * a.search.ImageSearch.RESTRICT_FILETYPE - 当此限制类型指定为 type
	 * 值时，图片搜索结果会仅限于特定文件类型（例如 JPG）的图片。此类型的有效可选值如下所示：
	 * a.search.ImageSearch.FILETYPE_JPG - 只限于 jpeg 图片
	 * a.search.ImageSearch.FILETYPE_PNG - 只限于 png 图片
	 * a.search.ImageSearch.FILETYPE_GIF - 只限于 gif 图片
	 * a.search.ImageSearch.FILETYPE_BMP - 只限于 bmp 图片
	 * 
	 * 以下代码段演示了如何仅检索 PNG 类型的图片。 
	 * var searcher = new a.search.ImageSearch();
	 * searcher.setRestriction(a.search.ImageSearch.RESTRICT_FILETYPE,
	 * a.search.ImageSearch.FILETYPE_PNG);
	 * 
	 * a.search.ImageSearch.RESTRICT_IMAGETYPE - 当此限制类型指定为 type
	 * 值时，图片搜索结果将限于特定类型的图片。此类型的有效可选值如下所示：
	 * a.search.ImageSearch.IMAGETYPE_FACES - 限于其中具有面部的图片
	 * a.search.ImageSearch.IMAGETYPE_PHOTO - 限于照片新增！
	 * a.search.ImageSearch.IMAGETYPE_CLIPART - 限于剪贴画图片新增！
	 * a.search.ImageSearch.IMAGETYPE_LINEART - 限于素描画图片新增！
	 * 
	 * 以下代码段演示了如何检索面部图片。
	 * var searcher = new a.search.ImageSearch();
	 * searcher.setRestriction(a.search.ImageSearch.RESTRICT_IMAGETYPE,
	 * a.search.ImageSearch.IMAGETYPE_FACES); 
	 * 
	 * 对于一个稍加完整的实例，如果您想要在 Carmen
	 * Electra 灰度图片中搜索面部图片（仅为 jpg 类型的图片），
	 * 
	 * 则以下代码段将演示如何实现此操作。 
	 * var searcher = new
	 * a.search.ImageSearch();
	 * searcher.setRestriction(a.search.ImageSearch.RESTRICT_IMAGETYPE,
	 * a.search.ImageSearch.IMAGETYPE_FACES);
	 * searcher.setRestriction(a.search.ImageSearch.RESTRICT_FILETYPE,
	 * a.search.ImageSearch.FILETYPE_JPG);
	 * searcher.setRestriction(a.search.ImageSearch.RESTRICT_COLORIZATION,
	 * a.search.ImageSearch.COLORIZATION_GRAYSCALE);
	 * searcher.execute('Carmen Electra');
	 * 
	 * @param type
	 * @param opt_value
	 */
	public void setRestriction(String type, String opt_value);
	
	/**
	 * 此方法用于限制由此搜索器返回的图片搜索结果集。要限制为
	 * www.photobucket.com，只需通过传递一个“www.photobucket.com”值调用此方法。要清除网站限制，请传递值
	 * null。
	 * 
	 * 以下代码段演示了将限制设置为“photobucket.com”。
	 * 
	 * var siteSearch = new GimageSearchgoogle.search.ImageSearch();
	 * siteSearch.setSiteRestriction("photobucket.com");
	 * 
	 * @param site
	 */
	public void setSiteRestriction(String site); 

}
